home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / graphic / vgacap81.zip / VGACAP.DOC < prev    next >
Text File  |  1992-07-12  |  25KB  |  583 lines
  1.        VGACAP (c) Copr. 1987-92 Lawrence Gozum & Marvin Gozum
  2.        ───────────────────────────────────────────────────────
  3.  
  4.                                  User Manual
  5.  
  6.     DISCLAIMER
  7.  
  8.     This product is distributed AS IS.  The authors specifically disclaim
  9.     all warranties ,expressed or implied, including ,but not limited to,
  10.     implied warranties of merchantability and fitness for a particular
  11.     purpose with respect to defects in the diskette and documentation, and
  12.     program license granted herein, in particular, and without limiting
  13.     operation of the program license with respect to any particular
  14.     application use or purpose.  In no event shall the authors be liable
  15.     for any loss of profit or any other commercial damage including but
  16.     not limited to special, incidental, consequential or other damages.
  17.  
  18.  
  19.     LICENSING AGREEMENT
  20.  
  21.     You may use this program for a 10 DAY TRIAL PERIOD.  Should you find
  22.     this program useful, you MUST register it; you will then be provided
  23.     with the latest releases of the VGACAD system see last section of this
  24.     manual).  Freely distribute UNMODIFIED copies of VGACAP*.ZIP and charge
  25.     $10 max for distribution, in lieu of recognized Users Group guidelines
  26.     (e.g., Asso. of Shareware Professionals or NY Amateur Computer Club).
  27.  
  28.  
  29.     WHAT IS VGACAP ?
  30.  
  31.     VGACAP is a resident utility that captures pictures in
  32.  
  33.          EGA 640x250x16
  34.         MCGA 320x200x256
  35.          VGA 640x480x16
  36.         SVGA 640x480x256
  37.         SVGA 800x600x16
  38.         SVGA 800x600x256
  39.         SVGA 1KBx768x16
  40.         SVGA 1KBx768x256
  41.         SVGA 1280x1024x16
  42.  
  43.     VGACAP captures to *.RAW file files (ie., "RAW" pixel dumps).  MCGA/VGA
  44.     320x200x256 pictures can optionally be saved in a BLoaDable format
  45.     for BASIC programming.
  46.  
  47.  
  48.     WHAT IS VGAFIL ?
  49.  
  50.     VGAFIL is a conversion program for use in a batch file (*.BAT) or as an
  51.     interactive stand-alone program; it is designed to integrate with VGACAD
  52.     v2.0 (and up) and replace BLD2GIF and RAW2GIF.  Moreover, it encodes
  53.     captured images to 256-color GIF, PCX, TIF, or BMP (Windows 3.x) files.
  54.     You can also select 16-color GIF files, and 32768-color TGA (Targa 16).
  55.  
  56.     VGAFIL also configures VGACAP to take advantage of specific SVGA chipset
  57.     hardcoding for FAST screen captures.
  58.  
  59.     VGACAP and VGAFIL can be viewed as a generic conversion utility system
  60.     since almost any EGA/MCGA/VGA/SVGA image from (320x200 to 1024x768) that
  61.     can be viewed, can be converted to/from GIF, PCX, BMP or TGA format !
  62.     If you can view files using 'less popular formats', you can capture and
  63.     convert them like so ...
  64.  
  65.    'LESS POPULAR'
  66.     FILE FORMATS (input)
  67.  
  68.      EFS  \
  69.      WIPS  \
  70.      SFP    \
  71.      PIG     \
  72.      RAS      \ YOUR   -->  SVGA
  73.      ISF      / VIEWER --> SCREEN
  74.      PDA     /               |        CAPTURED      VGAFIL
  75.      DEGAS  /              VGACAP --> RAW FILES --> UTILITY
  76.      GEM   /                                           |
  77.      ETC  /                                            |
  78.                          'MORE POPULAR'
  79.                           FILE FORMATS (output)
  80.  
  81.                               GIF
  82.                               PCX
  83.                               BMP (Windows 3.x)
  84.                               TGA (Targa)
  85.                               TIF (TIFF P)
  86.  
  87.     REQUIREMENTS
  88.  
  89.     About 512KB of memory is required for VGAFIL, although it uses about 2/3
  90.     of that; it, also, requires that the BRUN41.exe runtime module be present
  91.     in your present path; this is explained later in this manual.  You MUST
  92.     have an EGA or MCGA card.  To grab 640x480x16 screens you must have VGA;
  93.     for 640x480x256 (and above) grabs, you MUST have SVGA.  VGACAP uses
  94.     about 4KB of RAM.
  95.  
  96.  
  97.     COMPATIBILITY
  98.  
  99.     If you grab a screen from an application that "simulates" the SVGA
  100.     640x480x256 mode and get 1/4th of the screen or get four 1/4ths of
  101.     the screen then you grabbed from the unsupported 360x480x256 mode
  102.     NOT a real SVGA 640x480x256 screen; you must configure that application
  103.     for a TRUE 640x480x256 SVGA mode if your card supports it.
  104.  
  105.     The BRUN41.exe runtime module HATES 'Shadow RAM' (ie., putting your
  106.     SYETM or VIDEO BIOS in RAM); it 'hangs' (at least on our 386 SX).
  107.     If VGAFIL 'locks-up' at start-up then you have this problem too;
  108.     disable 'Shadow RAM' (eg., via CMOS set-up) and it should work.
  109.  
  110.     Trident TVGA card users that have the supposedly rare 'BR versions'
  111.     will notice that the bank switching will be erroneous.  We tried to
  112.     accomodate this version but ended up compromising the more popular
  113.     TVGA 8800 and 8900 versions <sorry>.  The Trident 1024x768x256 grabs
  114.     are not supported at this time since it uses a very peculiar, card
  115.     specific, bank switching methodology (ie., it conflicts with SVGA
  116.     display conventions); screen grabs are limited 800x600x256 or
  117.     1024x768x16, if available.  This applies even to a VESA setup with this
  118.     card.
  119.  
  120.     VESA implementation was included for FAST grabs (vis-a-vis BIOS) on
  121.     those exotic SVGA cards with obscure chipsets; moreover, it also makes
  122.     installation easy for those who don't know what their chipset is.
  123.  
  124.     VESA grabs should work on all 256-color SVGA modes up to 1024x768x256.
  125.  
  126.     If VGACAP is configured for BIOS or VESA grabs, then 16-color screen
  127.     grabs are limited to 680x480 and 800x600 (if you try capturing greater
  128.     resolutions, you will get garbage).  With hardcoded chipset settings,
  129.     up to 1024x768 and 1280x1024 16-color grabs are possible.
  130.  
  131.     ATI SVGA card users CANNOT capture 1024x768x16 screens if they are
  132.     trigerred via mode 65 (hex) since this is the old packed mode that
  133.     is inconsistent with SVGA 16-color display conventions (garbled images
  134.     will result).  ATI users MUST view 1024x768x16 screens via mode 55 (hex),
  135.     the planar mode, to grab them.
  136.  
  137.     If you create CUSTOM colors in your Windows 3.x environment, the
  138.     BMP encoding algorithm may not work as well as it should; it will do
  139.     its best with the Windows 3.x default color palette.
  140.  
  141.     VGACAP has been tested to load and operate successfully after being
  142.     relocated to the UMB (Upper Memory Block) using DOS 5.0; if you
  143.     experience problems with relocation simple load VGACAP in "low"
  144.     memory.  We have NOT tested VGACAP loaded into EMS memory; it may work
  145.     way up there too - try it, if it works up there, let us know.
  146.  
  147.     If you are having compatibility problems with VGACAP (particularly SVGA
  148.     bank switching) or VGAFIL encoding, please contact Lawrence Gozum
  149.     [73437,2372] via CompuServe's
  150.  
  151.                   E-Mail
  152.                 or
  153.                 PICs Forum
  154.  
  155.  
  156.     CONFIGURING VGACAP
  157.  
  158.     VGACAP, on default, is set for BIOS; these are 'generic' and should work
  159.     with most, if not all, SVGA cards.  However, BIOS calls are slow and
  160.     sometimes unpredictable.  By using the hardware configuration, VGACAP
  161.     will capture screens in 2-3 seconds compared to about 20-30 seconds for
  162.     800x600x256 screens (based on 28ms HD on 16 MHz 386sx).
  163.  
  164.     To configure VGACAP for your specific hardware type
  165.  
  166.                         VGAFIL -V <ret>
  167.                                or
  168.                         VGAFIL -C <ret>
  169.  
  170.     A menu will guide you.  Simply select the letter which corresponds to
  171.     your video card chipset.  Remember, when in doubt, use BIOS or VESA
  172.     setup.  BIOS setups do not guarantee that it will work; generally, if
  173.     your video board manufacturer took care in writing its BIOS - it SHOULD
  174.     work; BIOS should grab up to 1024x768 256-color grabs.
  175.  
  176.     New! - VESA (Video Electronics Standards Association) support has been
  177.     added to capture 256-color screens (up to 1024x768x256) without knowing
  178.     what your chipset is.  Simply install your VESA driver then configure
  179.     VGACAP for VESA.  VESA support requires you to load a card-specific
  180.     resident program before VESA can be used.  An error message will result
  181.     if VESA has not been previously loaded; this will happen when you install
  182.     VGACAP with the VESA configuration or with VGAFIL, during configuration.
  183.  
  184.     Under certain circumstances (see compatibility section), VGAFIL will
  185.     r